readme.txt

Manx Aztec C65 for Apple II DOS 3.3
C II Vers. 1.05i 6502
(C) 1982, 1983 by Manx Software Systems

This zip file contains 2 Apple II DOS 3.3 emulator disk images:

White Disk 39A - Manx C Compiler (19xx)(-)(Disk 1 of 2).dsk
White Disk 39B - Manx C Compiler (19xx)(-)(Disk 2 of 2).dsk

Disk 1 is bootable. Disk 2 is not.

Disk 1 contains the Aztec C Version 1.05i native mode 6502 C Compiler for
Apple II DOS 3.3 and boots into the Aztec C shell.

The idea here is to create some work disks (also called scratch disks and
data disks) and use the VI editor that comes with all this to write your
program on a work disk from within the shell environment. (In the next
release Manx had apparently changed the name of the VI editor to VED).

Then use the compiler to compile the code from withing the shell
environment and the linker to link the code from within the shell.

Disk 2 contains the linker but is not bootable (as previously noted).

I will leave it up to you to set this up the way you wish to work with
it. I haven't a manual for this release.

I have included the manual from the next release of Aztec C and you may
consider using that release instead of this one. The compiler is the same
version and is available as 2 zip files of 8 diskimages from the
following links.

http://www.clipshop.ca/Aztec/C65DOS331.zip
http://www.clipshop.ca/Aztec/C65DOS332.zip

Whether you use this release or the newer one that the manual refers to
you need to know the basics of using and navigating the Aztec C shell.
The Apple II in native mode is too hard to navigate effectively for the
purposes of producing C programs without using the Aztec C shell. All
Aztec C compilers for the Apple II whether for DOS 3.3 or ProDOS 8 came
with the Aztec C Shell

Here's the abridged version:

1. Turn your caps lock off. Shell commands are lower case.

1.2 The 2 drive system used by the shell is described in detail both in
the manual and also below for your convenienece.

The following is semtantically modified as to how this release works but
otherwise the same as the manual.

1.3 Two Drive Environment

One of the nice features of the SHELL is it's use of two drive disk
systems. To illustrate this, insert a DOS initialized diskette into drive
two. To catalog drive 2, type:

ls d2

This is different from the DOS way of doing things in two ways. The
command name "ls" must be separated from its argument by at least one
space, not a comma. The second thing that is different is that this
command does not make drive two the active drive. Typing the "ls" command
by itself will still give the catalog for drive one. To change the active
drive, the "cd" command must be used. Type:

cd d2

to change the active drive from drive one to drive two. Now drive two
will be the active drive until another "cd" command is given, or the
system is rebooted.

The other nice feature for multi-drive systems is the concept of an
execution drive. For example, try typing:

ce d1
cd d2
c65

Note that the drive light on the active drive will go on as the SHELL
tries to find the program. Assuming that you don't have a program named
C65 on the scratch disk, the SHELL will then automatically check the
current execution drive. In this case the current execution drive will be
drive one, and the C65 program will be loaded The current execution drive
can be changed by using the "ce" command in a manner similar to the "cd"
command. 

Cancel out of the C65 program by typing ^C, 

For the purposes of the introduction portion of the manual, it is assumed
that the current execution drive is drive one, and that the current data
drive is drive two.

Disclaimer and Conditions of Use

This compiler is (C) 1982, 1983 by Manx Software Systems. I cannot
provide you with a legally licenced copy.

In using or distributing this compiler, you are must acknowledge and
accept complete responsibility and all liability as the result of your
use and/or distribution. You must further agree that I, Bill Buckels, am
not liable or responsible in any way for the results of said use or
distribution.

Visit the Aztec C Museum Website for additional information about Aztec C 
and other Aztec C compilers: 

http://www.clipshop.ca/Aztec/index.htm#apple

Bill Buckels
bbuckels@escape.ca
April 2008






